home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / database / fslabl35.arj / FSLABEL.DOC next >
Text File  |  1992-02-10  |  23KB  |  405 lines
  1.  
  2.                        ┌───────────────────────────┐
  3.                        │          FSLABEL          │
  4.                        │                           │
  5.                        │        Version  3.0       │
  6.                        │                           │
  7.                        │          (C) 1991         │
  8.                        │     Freestyle Software    │
  9.                        │    ALL Rights Reserved    │
  10.                        └───────────────────────────┘
  11.  
  12.  
  13.                    AW, MAW!  NOT ANOTHER DISK LABELER?!
  14.  
  15.      ────────────────────────────────────────────────────────────────-
  16.  
  17.            Yes, Virginia, there IS another disk labling utility on the
  18.      shareware market.   FSLabel is an automatic labeling program that
  19.      reads a floppy disk in either A: or B: drive, and prints the file
  20.      names on a page label with a title that you assign. What makes it
  21.      different from most other labeling programs?  FSLabel is designed
  22.      to use full page Avery(tm) labels and prints on a Hewlett Packard
  23.      Deskjet or LaserJet, or compatible printers. Most disk file read-
  24.      ing and labling programs use tractor labels and don't run on full
  25.      page printers.  Wait, there's more! FSLabel will print labels for
  26.      either 5.25" or 3.50"  diskettes!   You can also choose the label
  27.      you  want to print right on screen by simply moving the cursor to
  28.      the position of the label in a visual array.  Printing single la-
  29.      bles  of disk file names on full sheet lable pages was not a par-
  30.      ticularly easy task -- until FSLabel!
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                                USING FSLABEL
  37.  
  38.      ────────────────────────────────────────────────────────────────-
  39.  
  40.           First, read the user notice under 'Caveats' located later in
  41.      this document!  It notifies the user of liabilities and specific-
  42.      ally  instructs users about correct use and possible damages when
  43.      using  sheet  labels  with laser printers using this or any other
  44.      sheet label software.
  45.  
  46.            Load FSLABEL from the command line (or an equivalent execu-
  47.      tion menuing program) with the command FSLabel.   Press F1 to get
  48.      a little help if you need it.    FSLabel is designed to use Avery
  49.      diskette labels for 3.5" drives (Avery 5196), or labels for 5.25"
  50.      drives (Avery 5197).  The 3.5" labels are 2.25 X 2.25 inches, and
  51.      the 5.25" labels are 1.5 X 4.00 inches.   Obviously,  the limita-
  52.      tions of FSLabel are the requirements for legitimate diskette la-
  53.      bels,  and HP compatible printers  with BOTH 6 point and 12 point
  54.      fonts  available  to the printer,  either as internal fonts or as
  55.      cartridge  fonts.  If the 6 point 20 pitch  fonts used to squeeze
  56.      the file names into the smallest possible space is NOT available,
  57.      FSLabel  will  default to the 16.66 by 8.5 point Lineprinter font
  58.      internal to most HP II compatibles.  In the later case, registra-
  59.      tion becomes critical,  as the type size is much larger.  FSLabel
  60.      version  3.0 does NOT currently have user support  for other type
  61.      styes or font sizes.  It's ABSOLUTELY necessary to have the stan-
  62.      dard  courier type  style INTERNALLY  available in BOTH 12/10 and
  63.      6/20 font sizes. FSLabel version 3.0 does NOT provide support for
  64.      soft fonts, but DOES support two cartridge fonts for use in prin-
  65.      ting the title of the printed label. Those are TIMES ROMAN 10/10,
  66.      and HELVETICA 10/10.  To print labels with either Times Roman, or
  67.      Helvetica, simply insert the appropriate cartridge in your print-
  68.      er.  If you have both cartridges,  REMOVE the one you DON'T want!
  69.      As a final word about type styles and sizes,  BEFORE you purchase
  70.      expensive labels, PLEASE try out FSLabel with plain paper to make
  71.      sure you have compatible fonts available in your printer!
  72.  
  73.          When you have sheet labels, and FSLable loaded, simply select
  74.      the label size by pressing the F5 key.  Select the drive with the
  75.      F8  key and insert a diskette you want to label.  Then use any of
  76.      the arrow keys to select the appropriate label position to print,
  77.      and press the Enter key.   This pops up a window to enter a title
  78.      for the given diskette.  Enter the title, and press the Enter key
  79.      to continue. Titles for 3.5" diskette labels are limited to twen-
  80.      ty three characters,  while titles for  5.25 inch  deskettes  are
  81.      limited to thirty six characters in length. Press F1 while enter-
  82.      a label to view editing commands.  After entering the title for a
  83.      label, just press the  ENTER  key and FSLabel will read the files
  84.      on  the  disk in the current drive and place them in a data array
  85.      for  that  specific label.   Continue until all the positions you
  86.      want to print are filled, or until the page is full. Press the F3
  87.      key to begin the printing sequence.   Make sure the page with the
  88.      labels is in your printer, and that the printer is ready.  If you
  89.      want  to  start  over  after  filling  several labels,  press  F4
  90.      and  the entire page will be cleared.   The arrays for each label
  91.      will be set to null.  After filling a label, the number will show
  92.      either in white on red (with a color system), or in inverse video
  93.      on a monochrome system.
  94.  
  95.         Pressing F6 from the main menu allows setting of Margins, File
  96.      Mask, Title\File Line Types, Saving current Settings,  Retrieving
  97.      Past Settings, or Restoring Default Settings.  IF SETTING CHANGES
  98.      ARE MADE (including default restorations),  they MUST BE SAVED TO
  99.      THE  DISK using SAVE  CURRENT  SETTINGS to make them RETRIEVABLE.
  100.      Saving  the  settings  creates  or  modifies  a data file  called
  101.      FSLabel.Dta.  If FSRead detects the file  at program startup,  it
  102.      retrieves  the settings contained in the file,  and become active
  103.      for the program session.
  104.  
  105.          Popular demand has encouraged some control of label registra-
  106.      tion.   Version 1.2 added the ability  to  adjust the position of
  107.      printing.  The defaults for 5.25" labels  and 3.5" labels are the
  108.      most common.   If necessary,  change starting row from the top of
  109.      the page, and the starting column from the left side.   BE  AWARE
  110.      THAT YOUR PRINTER  MAY  HAVE LIMITS TO BOTH TOP AND LEFT MARGINS.
  111.      Perforation skip (top margin),  and page offset (left margin) are
  112.      often hard set,  with  some overide possible with dip switch set-
  113.      tings.  Refer to  the manual for your printer to see if these are
  114.      manually modifyable with  dip switches.    IF  YOUR  TOP AND LEFT
  115.      MARGIN  ARE MECHANICALLY SET THROUGH YOUR PRINTER HARDWARE,  THEN
  116.      THE STARTING  ROW AND COLUMN SET WITH FSLABEL WILL BEGIN  AT  THE
  117.      MECHANICAL SETTINGS.   This  means  that if your printer has been
  118.      mechanically  set  to  include  a  1/2 inch top margin (four rows
  119.      down),  for  example,   then setting the top row  to one with FS-
  120.      Label will cause printing to begin on the FIFTH row.  In the same
  121.      way,  if your printer is mechanically set to include  a  1/2 inch
  122.      left margin,  setting the starting column  with FSLabel to 1 will
  123.      cause the printing to begin on the SIXTH column. If possible, set
  124.      both page offset,  and  perforation skip settings on your printer
  125.      to ZERO. In addition, Avery labels for 3.5" diskettes include TWO
  126.      rows of smaller tab labels  at the top of the page.   FSLabel de-
  127.      fault  top  margins have been set to skip down over these labels.
  128.      Place the sheet of labels  in your  printer  with  these  smaller
  129.      labels entering the printer FIRST.   Otherwise,  printing will be
  130.      forced down the page and registration will NOT be correct. Final-
  131.      ly,  make sure your printer is on and ready to print before pres-
  132.      sing the Enter key from  the title input window to begin.
  133.  
  134.         You also may specify a DOS file mask to screen files for view-
  135.      ing or printing.  Press  F6 from the main menu and select Set DOS
  136.      File  Mask.  Simply enter the mask  as you would from the command
  137.      line.  For example,  entering  *.EXE  would cause FSLabel to read
  138.      only executable files into the viewable/printable array. Simarly,
  139.      entering Letters.* would read files with any extention,  but only
  140.      with the name 'Letters.'  View files on a disk with any file mask
  141.      by pressing the F2 key from the main menu.
  142.  
  143.         If you want to change the line type separating the label title
  144.      from  the  subsequent filenames,  press F6 from the main menu and
  145.      select  Set Title/File Separator.  Some printers  have  failed to
  146.      recognize  the IBM extended characters of the solid single or so-
  147.      lid double line types.  If your printer prints a row of undesire-
  148.      able characters instead of a line, select either one of the dash-
  149.      ed lines or no line separator at all.
  150.  
  151.         Optionally, you may add a line of comment to each label title.
  152.      Simply press  F6  from the main menu to the set/modify parameters
  153.      menu,  and  toggle the Add Comment Line option to 'YES'.  You may
  154.      change  back  to  'NO'  if  you like.   The current setting (yes,
  155.      or no) is saved to the parameters file on the disk, and retrieved
  156.      at program startup.  Default setting is 'NO'.  There are restric-
  157.      tions  to  this option.   First it takes up a line of space,  and
  158.      therefore reduces the maximum number  of files that will fit onto
  159.      a label.   Second, you MUST toggle to 'YES' or 'NO' BEFORE begin-
  160.      ning  to fill out a screen page of labels.   In addition, you may
  161.      ONLY run a page print as the toggle is set.   That means you must
  162.      either  select  either 'YES' or 'NO'  to  add comments to a given
  163.      page print run.  Each print run for a page must be set one way or
  164.      the other.  You cannot mix filled labels on a page with and with-
  165.      out comments.   To print one or more labels on a single page both
  166.      with AND without comments, do the following:  Select and fill la-
  167.      bels for those WITHOUT comments and print the page.   Replace the
  168.      page with all labels intact in the printer.  Then select and fill
  169.      the  remaining positions WITH comments,  and print the page again
  170.      for  the remaining labels.   If you begin to fill a page with the
  171.      toggle set either to 'YES' or 'NO', and then decide to switch the
  172.      option toggle,  you MUST first clear the page with the F4 key and
  173.      start filling label positions again.  Use the comment line option
  174.      to add a date, make an additonal note, or give instructions  such
  175.      as "Type RunMe to run program," etc.
  176.  
  177.         If you have tested or set margins, or ANY of the other parame-
  178.      ters  with FSLabel,  you may save your current settings to a disk
  179.      file by pressing F6 from the main menu and selecting Save Current
  180.      Settings.  This creates and/or overwrites a file  on  the disk in
  181.      the same directory  as  FSLabel called FSLabel.Dta.  The selected
  182.      drive, label size, margins for 5.25" AND 3.5" disks, the DOS file
  183.      mask,  and the current Title/File line separator type are all in-
  184.      cluded and preserved.  Remember, these settings are ONLY saved if
  185.      you  choose  to  save them with the option described above.  Once
  186.      saved, the settings are automatically retrieved each time you run
  187.      FSLabel.  You may restore defaults  with the Restore Default Set-
  188.      tings selection, or retrieve previous settings again with the Re-
  189.      trieve Past Settings selection. If you have tediously tested mar-
  190.      gins and saved the settings, and then choose to restore defaults,
  191.      YOU MUST RETRIEVE THE PAST SETTINGS BEFORE SAVING SETTINGS AGIAN.
  192.      Otherwise, the restored defaults will be those saved to the disk.
  193.      Label titles and directory path strings are NOT saved.
  194.  
  195.          Because each label has a limited size,  the maximum number of
  196.      files that FSLabel can print on a single label is 45.  Even using
  197.      type reduced to 6 point size,  any more names simply won't fit on
  198.      a label.  The F2 key will display the  FIRST 45 files encountered
  199.      on a disk in the current drive that matches the current DOS mask.
  200.      Printing a label prints the FIRST 45 file names matching the cur-
  201.      rent DOS mask onto a label.  If there are additional files on the
  202.      disk, they will be ignored.  Remember, files are read, displayed,
  203.      and printed according to the current DOS file mask setting. Addi-
  204.      tionally, the maximum number of files that will fit on a label is
  205.      reduced when the optional comment line is added to titles.  Maxi-
  206.      mum  numbers are reduced to 40 file names for 5.25" labels and 42
  207.      for  3.5" labels.  This is because an additional line of space is
  208.      added  to  below  the  title and above the separator line for the
  209.      comment.
  210.  
  211.          Here's a tip about printing single labels.  Since page labels
  212.      feed from the top forward,  pages feed more reliably when top la-
  213.      bels are left unpeeled.  This is because the labels give the thin
  214.      label page backing support for a firmer, stiffer page.   So it is
  215.      a good idea to begin  printing single labels at the BOTTOM of the
  216.      page, instead of the top.  It's therefor better to start printing
  217.      the  LAST  label on a page and work backward to label number one.
  218.      In  this way you can print labels for one or two disks,  and pre-
  219.      serve the rest of the page for later use, with top labels left in
  220.      place.
  221.  
  222.          FSLabel is well bullet proofed for errors and is resistent to
  223.      system crashing.   The most probable source of errors is from the
  224.      printer, or from the disk drives or one of the diskettes.  If you
  225.      receive an error report, it will be specific and tell you exactly
  226.      what the problem is (printer not ready, drive not ready, bad sec-
  227.      tor on disk, etc.). Just attempt to correct it.  The printer rou-
  228.      tine times each print communication  between the computer and the
  229.      printer.  If the printer does  NOT  send  back  a signal for more
  230.      than 10 seconds,  then an error is presumed  (if the printer runs
  231.      out of paper, etc.), and you will be notified.  Otherwise, that's
  232.      about it.  FSLabel is simple,  useful, and practical.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                          HISTORY OF VERSION CHANGES
  241.  
  242.      ────────────────────────────────────────────────────────────────-
  243.  
  244.          Version 1.0 contained a memory allocation bug.   It was fixed
  245.      in Version 1.1.   Version 1.2 added modest registration capabili-
  246.      ties, AND was modified to find ALL DOS files and directories, ex-
  247.      cept hidden files. Previous versions found files set to read only
  248.      or  archive.  Version 1.3 added file masking,  and the ability to
  249.      save/retrieve  setups.  Version 1.4 fixed  a  display bug and ad-
  250.      ded the capability to print  DIRECTORIES  IN BOLD ITALICS to dis-
  251.      tinguish  them  from other files.   In  addition, 1.4 also allows
  252.      separate margin settings  for both 3.5" and 5.25" diskettes,  and
  253.      saves  both settings to disk.  Version 1.5  fixed another display
  254.      bug  and added a setup option to select the type of line to sepa-
  255.      a label title and the subsequent filenames.  Version 1.6 improved
  256.      several display and message procedures, as well as documentation.
  257.      Version 1.7  again  slightly improved label/printer registration,
  258.      and  forced  the most  recent label title to remain in memory for
  259.      those making several backups or copies.  (Ctrl-End clears a label
  260.      title.)   Version 1.7  also  added the option to view/print files
  261.      in  a  directory on the disk in the current drive,  and now high-
  262.      lights  directories  onscreen  when  files are viewed with the F2
  263.      key from the main menu.  Version 1.8 removed slight bugs from the
  264.      directory selection procedures, and upgraded help and screen dis-
  265.      play to reflect all previous changes.  Version 1.9 fixed a bug in
  266.      the line editing procedure.  Version 2.0 added the much requested
  267.      ability to select each label one by one,  place  a  corresponding
  268.      disk in the current drive, and subsequently fill a data array for
  269.      each label on a page.  Pressing the F3 key then begins the print-
  270.      ing sequence.  You can now print from one to all labels on a page
  271.      at once, corresponding  to  any filled positions  on  the screen.
  272.      Version  2. 1 corrected a bug in the file display feature,  where
  273.      file  names  failed  to become visible after a failed printer at-
  274.      tempt.   Version 2.1 also added a verification query to the print
  275.      option, to prevent accidental or premature printing.  Version 2.2
  276.      polished screen display and inface procedures,  as well as adding
  277.      the  ability to add an optional line of comments to label titles.
  278.      Version  2.2  and finally, 3.0, corrected many registration prob-
  279.      lems reported by users.
  280.  
  281.      VERSION CHANGES WERE IN RESPONSE TO SUGGESTIONS BY FSLABEL USERS.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.                              FOR ETHICAL USERS
  290.  
  291.      ────────────────────────────────────────────────────────────────-
  292.  
  293.             Try FSLabel.   Distribute it freely.  If you're amused  by
  294.      it, but find no use for it, don't worry about it.  If it's  cute,
  295.      but  beneath  your  dignity, give it away.  Still,  if  you  find
  296.      yourself  USING  it, if it WORKS for you,   the shareware license
  297.      fee is $15.00.
  298.  
  299.              It's  the  nature and spirit of things that  really  make
  300.      them  valuable to us.  FSLabel CAN make organizing personal disk-
  301.      ette  maintanence  a  great deal faster and easier.   While there
  302.      are plenty of others on the market, FSLabel has several very rea-
  303.      sonable features you may not find at ANY price. It is a great aid
  304.      to owners or users of laser printers. These features can save you
  305.      personal time.
  306.  
  307.             If FSLabel saves time, it saves money.  At $15.00, the FS-
  308.      Label License  is nominal.   If it only saved  a  few accumulated
  309.      hours in the course of a season,  it would still be  significant.
  310.      Your own time is unquestionably  worth more than a few dollars an
  311.      hour, isn't it?
  312.  
  313.            FSLabel is copyrighted. If you use FSLabel, Send your check
  314.      or money order to Freestyle Software, 24307 Magic  Mountain Park-
  315.      way,  Suite 255, Valencia, CA 91355.  The FSLabel license is only
  316.      $15.00.   So if you use it,  be dignified  enough to register it.
  317.      It's the right thing to do.  (Yeah, yeah...He's Naive!)
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                 DISCLOSURES
  326.  
  327.      ────────────────────────────────────────────────────────────────-
  328.  
  329.                FSLabel contains  assembly units  licensed  from  Eagle
  330.      Performance Software.  It was written in Turbo Pascal 5.5.  Turbo
  331.      Pascal  is  a  trademark of Borland International.   Deskjet  and
  332.      Laserjet  are  registered  trademarks of the Hewlett Packard cor-
  333.      poration, and naturally,  IBM  is  a  trademark  of International
  334.      Business Machines.   The Freestyle Company belongs to my wife and
  335.      me.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.                                  CAVEATS!
  344.  
  345.      ─────────────────────────────────────────────────────────────────
  346.  
  347.                                   NOTICE!
  348.  
  349.        Please read this notice!!!   Take special care when running la-
  350.      ble sheets through with lables removed!  The heated drum on laser
  351.      printers can melt the waxed paper exposed from removed labels and
  352.      cause  serious damage to the drum or drum cartridge.  This is NOT
  353.      a  problem  with  Deskjet  inkjet printers as they have no heated
  354.      drum. Most users of laserjet printers have not reported problems,
  355.      but as a few users have, it's therefore best  to  be very careful
  356.      with label sheets that contain missing labels.
  357.  
  358.                                FURTHERMORE!
  359.  
  360.        This  program is provided on an as is basis!  The user  assumes
  361.      ALL risk as to the performance,  quality,  or reliability  of the
  362.      product.  No warranties,  implied or otherwise, are made, includ-
  363.      ing, but not limited to,  any  'implied' warranties  of merchant-
  364.      ability,  fitness,  or suitability  for any particular purpose or
  365.      design.  A user waives  ALL other claims,  and the Freestyle Com-
  366.      pany,  or any other purveyor  or dealer of this product,  becomes
  367.      free from responsibility of ALL liabilities  or damages,  includ-
  368.      ing, but not limited to, lost revenues or profits,  unsuitability
  369.      of performance for a user's particular needs,  damage to a user's
  370.      computer hardware or software, any other incidental or consequen-
  371.      tial damages arising out of the use  of or inability  to use this
  372.      program, even if the Freestyle Company has been advised of possi-
  373.      ble damages, or aware of software shortcomings.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.                            OTHER FREESTYLE PRODUCTS
  382.  
  383.      ────────────────────────────────────────────────────────────────-
  384.  
  385.             If you like FSLabel, you might also find use for FSRead, a
  386.      very  fast text file browser that allows loading files up to 425K
  387.      into memory.    Change drives from an automacally  built  menu of
  388.      drives,  or directories from a full graphic tree. Choose up to 36
  389.      color attribute combinations for file viewing.  Mark text blocks,
  390.      or enter text strings for searches, and set place markers for ex-
  391.      tremely quick searching.   Print out all, or just portions of any
  392.      text file.  FSRead was written as a shareware documentation  file
  393.      reader, and is entirely light bar menu driven, with pop-up inter-
  394.      active help.   Then there's FSCalc,  a pop up calculator with its
  395.      own printable tape. It can be run either from the command line or
  396.      as a TSR.  FSCalc is a convenient personal calculator with calcu-
  397.      lator display features that make it  as familiar as any palm tape
  398.      calculator.  You may also be interested in FSText,  a quick style
  399.      analyzer for readability, personal interest,  and  negativity  of
  400.      writing for journalism, public relations, or advertising copy.
  401.  
  402.      ────────────────────────────────────────────────────────────────-
  403.  
  404.                           END FSLABEL DOCUMENTATION
  405.